home *** CD-ROM | disk | FTP | other *** search
/ El Mac 8 / El Mac 8.iso / Shareware / Utilities / PowerReplace 4.5.5 / Documentation / 5. Version 4.5 readme < prev    next >
Encoding:
Text File  |  1996-03-08  |  4.4 KB  |  94 lines  |  [ttro/ttxt]

  1.  
  2.   
  3.  
  4.  
  5.  
  6.  
  7.                                                                                           Version 4.5 Readme
  8.                                               for PowerReplace, March 9, 1996
  9.  
  10. Many important improvements in the version 4.5.
  11. _______________________________________________________________________________________
  12. Character set:
  13. The version 4.5 supports all character set in filter files, the control characters (0-31) in particular.  We can specify characters in filters by using ASCII numbers in decimal, hexadecimal or octal base. For example, "\d065" "\x41" "\o101" (or "\101") all means the same character "A".
  14. Good Example:
  15.    "\d65B"  "B\101\x43" % change "AB" to "BAC"
  16.   "\0"     ""          % strip NULL
  17.  
  18. Hexadecimal string:
  19. This version supports hexadecimal string in filters. The hex-string must be enclosed by dollar-sign($hex-string$). You can use one of the follow lines to convert "AB" to "BAC":
  20. Good Example:
  21.       "AB"      "BAC"                            % change "AB" to "BAC"
  22.    $6566$    $666567$                % change "AB" to "BAC"
  23.    $6566$    "BAC"                            % change "AB" to "BAC"
  24.    "AB"      $666567$                % change "AB" to "BAC"
  25.  
  26. Regular expression (pattern):
  27. This version supports Unix regular expression (pattern) for searching string. The pattern must be enclosed by single quotation marks ('pattern'). In PRExpression, we can only use pattern for first-string but not for the second-string. Here is a small description of pattern supported by PowerReplace:
  28.  
  29. Uppercase and lowercase are always ignored. An ordinary character (not mentioned below) matches that character.
  30.  
  31. ^             matches beginning of line
  32. $             matches end of line
  33. \       quotes character after it, whether special or not
  34. .       mathches any character
  35. *       a single character followed by * matches 
  36.      zero or more occurrences of the character. 
  37.      In particular, ".*" matches an arbitrary possibly empty string.
  38. +    a single character followed by + matches 
  39.      one or more occurrences of the character. 
  40. [ ]  a set of characters in the set matches any single character in the set. 
  41.      [c1-c2] matches any character of ascii ranging from c1 to c2.
  42.                     [^set] matches any character not in set. 
  43. See also any Unix book for more information about pattern.
  44. Good Example:
  45.    '^ +'        ""  % strip spaces at beginning of line.
  46.  
  47. Extension of PRExpression format:
  48. The PRExpression format has been extended to be able to support hex-string and pattern as mentioned above. Any way, the old format (version number<4.5) is 100% compatible with this extension. Here is the syntax for the new PRExpression format:
  49. PRExpression:
  50.              "first-string"    "second-string"\r   or
  51.     $hex-string$      "second-string"\r   or
  52.     "first-string"    $second-string$\r   or
  53.     $hex-string1$     $hex-string2$" \r   or
  54.     'pattern'         "second-string"\r   or
  55.     'pattern'         $second-string$\r   
  56.  
  57. Bad Example:
  58.    '^ +'             'abc'    % pattern at the second position 
  59.    $A9876$           ""       % bad hex-string, length odd
  60.    "a*b*c"     "\xB3"   % two * in the first-string, try "a*b\*c" "\xB3"
  61.    '[aeiou'       " "                     % pattern syntax error
  62.    "a"a"                            "AA"                    % syntax error. try "a\"a" "AA"
  63.    "\da"       "a"                     % decimal number error
  64.    $23"        "98"     % syntax error. try  $23$ "98" 
  65.    $A567BDG$   "98"     % bad hex-string
  66.    "toto"                     "t*t"    % bad second-string, try "toto" "t\*t"
  67.  
  68.  
  69. “Char Convert Only” is now automatic:
  70. There is no “Char Convert Only” option in the “Make PowerReplace Filter File” window, which appeared in old versions. Now this option is automaticaly set by PowerReplace if possible. See alse FAQ [Q10].
  71.  
  72. Some changes for Filter Folder:
  73. - Scans all filter files in the “Filter” folder, even those that lie in the sub-folders.
  74. - If there is too many filter files, you can mask someone of them by labelling (coloring) under Finder. PowerReplace scans only the folder and filter file without label(color).
  75. - Added filter files writen by the users of PowerReplace in the sub-folder “Collection”.
  76. - See also “FilterFile Doc” file for new filter files in the “Filter” folder.
  77.  
  78. Menu:
  79. The name of the current filter file will appear on the menu bar after the menu “Filter”.
  80.  
  81. Application size:
  82. This version minimizes the application size by removing some codes.
  83.  
  84. Fixed the “End” bug:
  85. A line starting with the percent-sign(%) is a comment. In particular, the line
  86. %end
  87. at the end of a filter is optional.
  88.  
  89. _____________________________
  90. Guoniu Han
  91. email: guoniu@math.u-strasbg.fr
  92. http://130.79.4.26/~guoniu/mac/
  93. _____________________________
  94.